Node / meshtastic / Meshtastic-Android / files / core / database / src / commonTest / kotlin / org / meshtastic / core / database / DeviceIdentityTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.database

Tff7b72import T7ee787androidx.datastore.preferences.core.preferencesOf

Tff7b72import T7ee787org.meshtastic.core.database.entity.MyNodeEntity

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertNull

Tff7b72import T7ee787kotlin.test.assertTrue

T8b949e/** Covers the cross-transport DB-claim helpers behind [DatabaseManager.associateDevice]. */

Tff7b72class T56d364DeviceIdentityTest Tb4b4b4{

Tf0883e@Test

Tff7b72fun Td2a8ffvalidDeviceIdRejectsAbsentBlankPlaceholderAndNonHexFormsTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertNullTb4b4b4(Te6edf3validDeviceIdOrNullTb4b4b4(Tff7b72nullTb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3validDeviceIdOrNullTb4b4b4(Ta5d6ff"Ta5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3validDeviceIdOrNullTb4b4b4(Ta5d6ff"Ta5d6ff Ta5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3validDeviceIdOrNullTb4b4b4(Te6edf3MyNodeEntityTb4b4b4.Te6edf3DEVICE_ID_UNKNOWNTb4b4b4)Tb4b4b4)

T8b949e// Legacy app versions persisted a lossy utf8 decode of the raw bytes — such values can

T8b949e// collide across devices and must be treated as absent, not compared.

Te6edf3assertNullTb4b4b4(Te6edf3validDeviceIdOrNullTb4b4b4(Ta5d6ff"Ta5d6ff��legacy idTa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3validDeviceIdOrNullTb4b4b4(Ta5d6ff"Ta5d6ffabcdefTa5d6ff"Tb4b4b4)Tb4b4b4) T8b949e// too short to be a real 16-byte id

Tff7b72val Te6edf3hexId Tff7b72= Ta5d6ff"Ta5d6ffa1b2c3d4e5f60718a9b0c1d2e3f40516Ta5d6ff"

Te6edf3assertEqualsTb4b4b4(Te6edf3hexIdTb4b4b4, Te6edf3validDeviceIdOrNullTb4b4b4(Te6edf3hexIdTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffdeviceKeyIsDeterministicAndDistinctPerDeviceTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ffhw-ATa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ffhw-ATa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertTrueTb4b4b4(Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ffhw-ATa5d6ff"Tb4b4b4) Tff7b72!Tff7b72= Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ffhw-BTa5d6ff"Tb4b4b4)Tb4b4b4)

T8b949e// Raw device-id bytes decode lossily to strings; the key must stay printable regardless.

Tff7b72val Te6edf3keyName Tff7b72= Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ff\Ta5d6ffuFFFD idTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3name

Te6edf3assertTrueTb4b4b4(Te6edf3keyNameTb4b4b4.Te6edf3startsWithTb4b4b4(Te6edf3DatabaseConstantsTb4b4b4.Te6edf3DEVICE_DB_FOR_PREFIXTb4b4b4)Tb4b4b4)

Te6edf3assertTrueTb4b4b4(Te6edf3keyNameTb4b4b4.Te6edf3dropTb4b4b4(Te6edf3DatabaseConstantsTb4b4b4.Te6edf3DEVICE_DB_FOR_PREFIXTb4b4b4.Te6edf3lengthTb4b4b4)Tb4b4b4.Te6edf3all Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3isLetterOrDigitTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffdeviceClaimIsPreferredOverNodeClaimTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3deviceKey Tff7b72= Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ffhw-ATa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3nodeKey Tff7b72= Te6edf3nodeDbPrefKeyTb4b4b4(T79c0ff1T79c0ff0T79c0ff0Tb4b4b4)

Tff7b72val Te6edf3prefs Tff7b72= Te6edf3preferencesOfTb4b4b4(Te6edf3deviceKey Te6edf3to Ta5d6ff"Ta5d6ffdb_deviceTa5d6ff"Tb4b4b4, Te6edf3nodeKey Te6edf3to Ta5d6ff"Ta5d6ffdb_nodeTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffdb_deviceTa5d6ff"Tb4b4b4, Te6edf3resolveDbClaimTb4b4b4(Te6edf3prefsTb4b4b4, Te6edf3deviceKeyTb4b4b4, Te6edf3nodeKeyTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffnodeClaimIsTheFallbackTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3deviceKey Tff7b72= Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ffhw-ATa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3nodeKey Tff7b72= Te6edf3nodeDbPrefKeyTb4b4b4(T79c0ff1T79c0ff0T79c0ff0Tb4b4b4)

Tff7b72val Te6edf3legacyOnly Tff7b72= Te6edf3preferencesOfTb4b4b4(Te6edf3nodeKey Te6edf3to Ta5d6ff"Ta5d6ffdb_nodeTa5d6ff"Tb4b4b4)

T8b949e// Device id available but only a legacy nodeNum claim exists (pre-device-id install).

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffdb_nodeTa5d6ff"Tb4b4b4, Te6edf3resolveDbClaimTb4b4b4(Te6edf3legacyOnlyTb4b4b4, Te6edf3deviceKeyTb4b4b4, Te6edf3nodeKeyTb4b4b4)Tb4b4b4)

T8b949e// No device id at all (classic ESP32, lockdown, old firmware).

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffdb_nodeTa5d6ff"Tb4b4b4, Te6edf3resolveDbClaimTb4b4b4(Te6edf3legacyOnlyTb4b4b4, Te6edf3deviceKey Tff7b72= Tff7b72nullTb4b4b4, Te6edf3nodeKey Tff7b72= Te6edf3nodeKeyTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffrenumberedDeviceStillResolvesItsClaimViaDeviceKeyTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3deviceKey Tff7b72= Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ffhw-ATa5d6ff"Tb4b4b4)

T8b949e// Claims written before a firmware 2.8 renumber: device key + OLD node num key.

Tff7b72val Te6edf3prefs Tff7b72= Te6edf3preferencesOfTb4b4b4(Te6edf3deviceKey Te6edf3to Ta5d6ff"Ta5d6ffdb_claimedTa5d6ff"Tb4b4b4, Te6edf3nodeDbPrefKeyTb4b4b4(T79c0ff1T79c0ff0T79c0ff0Tb4b4b4) Te6edf3to Ta5d6ff"Ta5d6ffdb_claimedTa5d6ff"Tb4b4b4)

T8b949e// After the renumber the node key is new and unclaimed — the device key still resolves.

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffdb_claimedTa5d6ff"Tb4b4b4, Te6edf3resolveDbClaimTb4b4b4(Te6edf3prefsTb4b4b4, Te6edf3deviceKeyTb4b4b4, Te6edf3nodeDbPrefKeyTb4b4b4(T79c0ff2T79c0ff0T79c0ff0Tb4b4b4)Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffunclaimedDeviceResolvesNothingTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertNullTb4b4b4(Te6edf3resolveDbClaimTb4b4b4(Te6edf3preferencesOfTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3deviceDbPrefKeyTb4b4b4(Ta5d6ff"Ta5d6ffhw-ATa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3nodeDbPrefKeyTb4b4b4(T79c0ff1T79c0ff0T79c0ff0Tb4b4b4)Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tb4b4b4}